home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.3 / OwnSelect.3 < prev    next >
Text File  |  1995-07-25  |  4KB  |  67 lines
  1.  
  2.  
  3.  
  4.      TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333))))           TTTTkkkk (((( ))))            TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn((((3333))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           Tk_OwnSelection - make a window the  owner  of  the  primary
  12.           selection
  13.  
  14.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.           ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  16.  
  17.           TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn(_t_k_w_i_n, _p_r_o_c, _c_l_i_e_n_t_D_a_t_a)
  18.  
  19.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  20.           Tk_Window        _t_k_w_i_n        (in)      Window  that  is  to
  21.                                                   become new selection
  22.                                                   owner.
  23.  
  24.           Tk_LostSelProc   *_p_r_o_c        (in)      Procedure to  invoke
  25.                                                   when   _t_k_w_i_n   loses
  26.                                                   selection  ownership
  27.                                                   later.
  28.  
  29.           ClientData       _c_l_i_e_n_t_D_a_t_a   (in)      Arbitrary   one-word
  30.                                                   value   to  pass  to
  31.                                                   _p_r_o_c.
  32.      _________________________________________________________________
  33.  
  34.  
  35.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  36.           TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn arranges for _t_k_w_i_n to become the  new  owner
  37.           of the primary selection.  After this call completes, future
  38.           requests for the selection  will  be  directed  to  handlers
  39.           created  for  _t_k_w_i_n  using  TTTTkkkk____CCCCrrrreeeeaaaatttteeeeSSSSeeeellllHHHHaaaannnnddddlllleeeerrrr.  When _t_k_w_i_n
  40.           eventually loses  the  selection  ownership,  _p_r_o_c  will  be
  41.           invoked  so  that  the  window  can clean itself up (e.g. by
  42.           unhighlighting the selection).  _P_r_o_c should  have  arguments
  43.           and result that match the type TTTTkkkk____LLLLoooossssttttSSSSeeeellllPPPPrrrroooocccc:
  44.                typedef void Tk_LostSelProc(ClientData _c_l_i_e_n_t_D_a_t_a);
  45.           The _c_l_i_e_n_t_D_a_t_a parameter to _p_r_o_c is a copy of the _c_l_i_e_n_t_D_a_t_a
  46.           argument  given to TTTTkkkk____OOOOwwwwnnnnSSSSeeeelllleeeeccccttttiiiioooonnnn, and is usually a pointer
  47.           to  a   data   structure   containing   application-specific
  48.           information about _t_k_w_i_n.
  49.  
  50.           Once a window has become selection  owner,  it  will  remain
  51.           owner until either the window is deleted or until some other
  52.           window claims ownership.  There is no way for  a  window  to
  53.           disavow ownership of the selection once it has received it.
  54.  
  55.  
  56.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  57.           own, selection owner
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/23/95)
  64.  
  65.  
  66.  
  67.